文档 / 子平台 API

游戏平台(小游戏)

游戏平台(games)分发网页小游戏(HTML + JS),用户在线游玩并提交分数到排行榜。游戏由代码资产 + 元数据 + 排行榜组成。

游戏元数据

字段说明
code唯一标识(如 game-2048
name / description8 语言
cover_url封面图
entry_html / src_url游戏入口(内嵌 HTML 或外部 iframe)
category分类(益智/动作/休闲…)
play_limit免费游玩次数

公开端点

GET /games/v1/games                        # 游戏列表(公开)
GET /games/v1/games/{code}                 # 详情
GET /games/v1/games/{code}/leaderboard     # 排行榜(公开)

排行榜设计

  • 匿名玩家按浏览器指纹归一到同一条"匿名分数"记录(同指纹刷新最大值,不同指纹新增);
  • 登录用户显示昵称;
  • 游戏结束提交分数,进入前 10 触发"破纪录"特效;
  • 结束必须消耗可玩次数,防止一直白嫖。

开发建议

  1. 游戏代码自包含(单 HTML 或纯 JS),无外部依赖;
  2. 移动端适配:iframe 高度要匹配游戏画布(如 2048 需额外 20px 显示分数栏);
  3. 提交分数接口带防刷(服务端校验分数合理性、频控);
  4. 每款游戏配一张 AI 生成的封面图。

游戏与插件的关系

游戏本质是"内容型插件":游戏市场 = 插件的展示形态 + 排行榜玩法。同一份代码资产可以既挂插件市场又挂游戏市场。